Paints a region with the graphics pen’s pattern and pattern mode.

void PaintRgn (
     rgn
);

Parameter descriptions

rgn

A handle to the region to paint.

DISCUSSION

Using the pen pattern and pattern mode for the current graphics port, the PaintRgn function draws the interior of the region whose handle you pass in the rgn parameter. The pen location does not change.

This function depends on the local coordinate system of the current graphics port. If you draw a region in a graphics port different from the one in which you defined the region, it may not appear in the proper position in the graphics port.

If any horizontal or vertical line drawn through the region would intersect the region’s outline more than 50 times, the results of this graphics operation are undefined.

Use FillRgn to draw the interior of a region with a pen pattern different from that for the current graphics port.

SPECIAL CONSIDERATIONS

The PaintRgn function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)